v25.5.2

Compare Source

• fix last change => for cjs there is just 1 default export, no named exports, fixes 2348

v25.5.1

Compare Source

• export keyFromSelector from index.cjs 2347

v25.5.0

Compare Source

• export keyFromSelector function for testing purposes 2346

v25.4.2

Compare Source

• fix: enableSelector: true doesn't work with custom keySeparator 2341

v25.4.1

Compare Source

• fix: KeyPrefix not working with new selector api 2340

v25.4.0

Compare Source

• add new selector API to improve TypeScript IDE performance 2322
  • To enable it, set enableSelector: true in your configuration options
  • With enableSelector: "optimize", i18next can now handle translation dictionaries of any size, without affecting IDE performance or build times
  • To assist with the migration, we've published the following packages:
    • @​i18next-selector/codemod
    • @​i18next-selector/vite-plugin

v25.3.6

Compare Source

• improve fix: Ordinals and non-ordinals don't work together 2337

v25.3.5

Compare Source

• fix: Ordinals and non-ordinals don't work together 2337

v25.3.4

Compare Source

• remove unnecessary debug logs

v25.3.3

Compare Source

• fix: Brackets breaking nesting interpolation 2336

v25.3.2

Compare Source

• fix dir() for non-Intl language codes 2330

v25.3.1

Compare Source

• warn if legacy interpolation.format function is still used

v25.3.0

Compare Source

• feat: support formatting function with plural and interpolation 2325
• fix dir() for Latn language codes 2324

v25.2.1

Compare Source

• streamline fallbackLng option of t call with the init options 2312

v25.2.0

Compare Source

• introduce cacheInBuiltFormats option to address 2227

v25.1.3

Compare Source

• Ensure nsSeparator is respected when appendNamespaceToMissingKey is true 2311, fixes 2310

v25.1.2

Compare Source

• do not mutate t options, fixes 2307

v25.1.1

Compare Source

• fix options type for parseMissingKeyHandler

v25.1.0

Compare Source

• feat: parseMissingKeyHandler now takes options as parameter like in missingKeyHandler 2304

v25.0.2

Compare Source

• fix cloneInstance with forkResourceStore: true addresses 2303

v25.0.1

Compare Source

• optimize changeLanguage to correctly use getBestMatchFromCodes (string or array) 2299 and improve resolvedLanguage set for non canonical codes

v25.0.0

Compare Source

This is a potentially breaking release:

• fix multiple changeLanguage call that may have result in wrong order in previous versions 1605 2298
• adapt changeLanguage to always (string or array) use getBestMatchFromCodes 2299
• getBestMatchFromCodes now tries to fallback to language code with same script 2299

v24.2.3

Compare Source

• Upgrade @​babel/runtime package to version v7.26.10 2293

v24.2.2

Compare Source

• fix: Interpolation fails with arrays (TypeError) and doesn't work with objects in defaultValue 1829

v24.2.1

Compare Source

• Standardize null/undefined checks across codebase 2275
• fix(typescript): make TFunction augmentable again 2279, fixes 2278

v24.2.0

Compare Source

• feat(typescript): Add strictKeyChecks option to enforce checking key existence when defaultValue is used 2274, fixes 2043

v24.1.2

Compare Source

• optimize fix: Bug Report: Unsafe Behavior in i18n.t Function Leading to Potential Code Execution 2273

v24.1.1

Compare Source

• fix: Bug Report: Unsafe Behavior in i18n.t Function Leading to Potential Code Execution 2273

v24.1.0

Compare Source

• try to address 2270 by cloning the store data 2271

v24.0.5

Compare Source

• remove extra log for 2268

v24.0.4

Compare Source

• simplify fix: incorrect locale detected 2268

v24.0.3

Compare Source

• fix: incorrect locale detected 2268
• fix: Intl.getCanonicalLocales throws with custom regions 2267

v24.0.2

Compare Source

• if no Intl api, log error and use dummy rule

v24.0.1

Compare Source

• early return and log error, if no Intl api

v24.0.0

Compare Source

This is a major breaking release:

• remove support for older environments
• remove old i18next JSON formats
  • To convert your existing v3 translations to the v4 format, have a look at i18next-v4-format-converter or this web tool.
• remove support for compatibility to v1 API
• Intl API is mandatory now and will not fallback anymore
• possible compatibility layer for older formats: test/compatibility/v4/v4Compatibility.js
• rename initImmediate to initAsync
• fallback to dev language if plural rule not found
• Dropped support for Node.js < v14
• remove TypeScript v4 support. TypeScript v5 is now an optional peer dependency
• addresses
  • 2244
  • 2184
  • 2213
  • 2206
  • 2208
  • 2148
  • 2254

➡️ check out the migration guide